Skip to content

Add typed workflow configuration#2468

Draft
NathanColosimo wants to merge 28 commits into
mainfrom
nathanc/unify-workflow-config
Draft

Add typed workflow configuration#2468
NathanColosimo wants to merge 28 commits into
mainfrom
nathanc/unify-workflow-config

Conversation

@NathanColosimo

@NathanColosimo NathanColosimo commented Jun 17, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

Closes #2446 with a small first version of shared Workflow configuration:

  • adds a Zod-validated workflow.config.ts, typed through workflow/config
  • configures a World by module path without importing it during config loading
  • shares build.dirs, build.projectRoot, and build.sourcemap across the CLI and framework integrations
  • preserves existing environment variables and framework options with explicit precedence

Application config

// workflow.config.ts
import type { WorkflowConfig } from 'workflow/config';

const config = {
  world: './workflow.world.ts',
  build: {
    dirs: ['workflows'],
    sourcemap: false,
  },
} satisfies WorkflowConfig;

export default config;

world accepts a path relative to workflow.config.ts or a package specifier.

World provider

The referenced module default-exports a WorldProvider:

// workflow.world.ts
import type { WorldProvider } from 'workflow/config';
import { createWorld } from '@workflow/world-postgres';

const world: WorldProvider = () =>
  createWorld({
    connectionString: process.env.WORKFLOW_POSTGRES_URL!,
    jobPrefix: 'myapp_',
    queueConcurrency: 50,
    maxPoolSize: 52,
  });

export default world;

The config loader validates and resolves the module without importing it. Each bundler aliases a stable internal World provider import directly to that module, so there is no generated runtime config or function serialization. The provider factory runs when the runtime first needs its World.

Worlds by environment

Environment selection stays inside the provider, where runtime environment variables are available:

// workflow.world.ts
import type { WorldProvider } from 'workflow/config';
import { createLocalWorld } from '@workflow/world-local';
import { createWorld as createPostgresWorld } from '@workflow/world-postgres';

const world: WorldProvider = () => {
  switch (process.env.APP_ENV) {
    case 'production':
    case 'preview':
      return createPostgresWorld({
        connectionString: process.env.WORKFLOW_POSTGRES_URL!,
      });
    case 'development':
    case 'test':
      return createLocalWorld();
    default:
      throw new Error(`Unexpected APP_ENV: ${process.env.APP_ENV}`);
  }
};

export default world;

Precedence and defaults

explicit CLI/framework options > environment variables > workflow.config.ts > defaults

WORKFLOW_TARGET_WORLD overrides the configured provider. Without either setting, Workflow selects the Vercel World on Vercel and the Local World elsewhere.

Open questions

  • Secrets live in workflow.world.ts, separate from build settings, but workflow.config.ts is still executable TypeScript at build time.
  • Existing withWorkflow and Nitro options remain activation points and explicit overrides; this PR does not deprecate overlapping options.
  • Existing environment variables remain backward compatible. A later migration can decide whether any should warn or be removed.

Verification

  • rebased onto current main
  • affected TypeScript packages compile successfully
  • core: 1,323 tests pass
  • builders: 205 tests pass
  • CLI, Next, Nitro, and SvelteKit package suites pass
  • docs: 1,020 checks pass, including sitemap guards
  • a configured Next/Turbopack app resolves and bundles the provider; the local full build reaches only its expected offline Google Fonts failure
  • all PR commits contain SSH signatures and Nathan's DCO signoff

Docs Preview

Page v5
Configuration Preview
withWorkflow Preview
Nitro Preview
Local World Preview
Postgres World Preview
Vercel World Preview
createWorld Preview
getWorld Preview
getWorldHandlers Preview

@changeset-bot

changeset-bot Bot commented Jun 17, 2026 •
edited
Loading

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: e393dbf

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 20 packages
Name Type
@workflow/next Minor
@workflow/nitro Minor
@workflow/sveltekit Minor
@workflow/astro Minor
@workflow/builders Minor
@workflow/cli Minor
@workflow/core Minor
@workflow/web Patch
@workflow/world Minor
workflow Minor
@workflow/nuxt Patch
@workflow/nest Patch
@workflow/rollup Patch
@workflow/vite Patch
@workflow/vitest Patch
@workflow/world-testing Patch
@workflow/web-shared Patch
@workflow/world-local Patch
@workflow/world-postgres Patch
@workflow/world-vercel Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercel Bot commented Jun 17, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Jun 24, 2026 5:07am
example-nextjs-workflow-webpack Ready Ready Preview, Comment Jun 24, 2026 5:07am
example-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-astro-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-express-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-fastify-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-hono-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-nitro-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-nuxt-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-sveltekit-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-tanstack-start-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workbench-vite-workflow Ready Ready Preview, Comment Jun 24, 2026 5:07am
workflow-docs Ready Ready Preview, 💬 3 unresolved, Open in v0 Jun 24, 2026 5:07am
workflow-swc-playground Ready Ready Preview, Comment Jun 24, 2026 5:07am
workflow-tarballs Ready Ready Preview, Comment Jun 24, 2026 5:07am
workflow-web Ready Ready Preview, Comment Jun 24, 2026 5:07am

@github-actions

github-actions Bot commented Jun 17, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

📈 Comparing against baseline from main branch. Green 🟢 = faster, Red 🔺 = slower.

workflow with no steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Nitro 0.048s (+3.0%) 1.006s (~) 0.958s 10 1.00x
💻 Local Express 0.049s (+2.9%) 1.006s (~) 0.957s 10 1.01x
💻 Local Next.js (Turbopack) 0.052s (-1.5%) 1.006s (~) 0.954s 10 1.07x
🐘 Postgres Express 0.067s (-3.7%) 1.012s (~) 0.945s 10 1.38x
🐘 Postgres Nitro 0.069s (+4.7%) 1.012s (~) 0.944s 10 1.42x
🐘 Postgres Next.js (Turbopack) 0.099s (+78.1% 🔺) 1.051s (+3.8%) 0.952s 10 2.04x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 0.292s (+26.6% 🔺) 2.055s (-2.3%) 1.762s 10 1.00x
▲ Vercel Nitro 0.329s (+30.8% 🔺) 2.482s (+14.4% 🔺) 2.152s 10 1.13x
▲ Vercel Next.js (Turbopack) 0.739s (+173.4% 🔺) 2.782s (+36.1% 🔺) 2.044s 10 2.52x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

workflow with 1 step

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Nitro 1.080s (~) 2.007s (~) 0.926s 10 1.00x
💻 Local Next.js (Turbopack) 1.084s (~) 2.006s (~) 0.922s 10 1.00x
💻 Local Express 1.084s (~) 2.007s (~) 0.923s 10 1.00x
🐘 Postgres Express 1.096s (~) 2.009s (~) 0.913s 10 1.01x
🐘 Postgres Nitro 1.097s (~) 2.009s (~) 0.912s 10 1.02x
🐘 Postgres Next.js (Turbopack) 1.159s (+6.9% 🔺) 2.063s (+2.7%) 0.905s 10 1.07x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 1.447s (+2.5%) 3.090s (-3.1%) 1.642s 10 1.00x
▲ Vercel Express 1.517s (+9.7% 🔺) 3.267s (+15.5% 🔺) 1.750s 10 1.05x
▲ Vercel Next.js (Turbopack) 2.191s (+52.8% 🔺) 4.070s (+21.4% 🔺) 1.879s 10 1.51x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 10 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 10.456s (~) 11.021s (~) 0.565s 3 1.00x
💻 Local Express 10.465s (~) 11.023s (~) 0.558s 3 1.00x
🐘 Postgres Nitro 10.467s (~) 11.017s (~) 0.551s 3 1.00x
💻 Local Nitro 10.476s (~) 11.023s (~) 0.547s 3 1.00x
🐘 Postgres Next.js (Turbopack) 10.489s (~) 11.020s (~) 0.531s 3 1.00x
💻 Local Next.js (Turbopack) 10.495s (~) 11.023s (~) 0.527s 3 1.00x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 11.809s (+0.8%) 13.943s (+4.4%) 2.134s 3 1.00x
▲ Vercel Express 11.827s (-3.9%) 13.375s (-3.6%) 1.548s 3 1.00x
▲ Vercel Next.js (Turbopack) 13.337s (+13.0% 🔺) 15.163s (+8.8% 🔺) 1.826s 2 1.13x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 25 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 13.609s (-0.8%) 14.019s (~) 0.410s 5 1.00x
💻 Local Express 13.654s (~) 14.028s (~) 0.375s 5 1.00x
🐘 Postgres Express 13.666s (+0.7%) 14.020s (~) 0.353s 5 1.00x
🐘 Postgres Next.js (Turbopack) 13.667s (~) 14.038s (~) 0.371s 5 1.00x
💻 Local Nitro 13.670s (~) 14.028s (~) 0.358s 5 1.00x
💻 Local Next.js (Turbopack) 13.678s (+0.7%) 14.027s (~) 0.348s 5 1.01x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 16.200s (-1.0%) 18.830s (+6.3% 🔺) 2.630s 4 1.00x
▲ Vercel Express 17.754s (+8.0% 🔺) 19.423s (+7.9% 🔺) 1.669s 4 1.10x
▲ Vercel Next.js (Turbopack) 18.059s (+4.1%) 20.167s (+5.3% 🔺) 2.107s 3 1.11x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 50 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Next.js (Turbopack) 12.108s (~) 12.518s (-3.8%) 0.409s 8 1.00x
💻 Local Express 12.175s (-1.3%) 13.026s (~) 0.851s 7 1.01x
💻 Local Nitro 12.229s (~) 13.026s (~) 0.797s 7 1.01x
🐘 Postgres Nitro 12.329s (~) 13.019s (~) 0.690s 7 1.02x
💻 Local Next.js (Turbopack) 12.365s (+0.9%) 13.027s (~) 0.662s 7 1.02x
🐘 Postgres Express 12.388s (+2.3%) 13.021s (~) 0.633s 7 1.02x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 17.226s (-9.2% 🟢) 20.024s (-3.0%) 2.797s 5 1.00x
▲ Vercel Express 19.425s (+5.7% 🔺) 21.743s (+7.9% 🔺) 2.317s 5 1.13x
▲ Vercel Next.js (Turbopack) 22.954s (+18.6% 🔺) 25.871s (+21.9% 🔺) 2.917s 4 1.33x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Promise.all with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.183s (~) 2.008s (~) 0.824s 15 1.00x
🐘 Postgres Express 1.200s (+2.7%) 2.021s (+0.6%) 0.821s 15 1.01x
🐘 Postgres Next.js (Turbopack) 1.228s (+4.4%) 2.011s (~) 0.783s 15 1.04x
💻 Local Express 1.410s (+1.5%) 2.007s (~) 0.597s 15 1.19x
💻 Local Nitro 1.450s (+0.8%) 2.007s (~) 0.557s 15 1.23x
💻 Local Next.js (Turbopack) 1.458s (-2.6%) 2.007s (~) 0.549s 15 1.23x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 2.046s (-3.9%) 3.778s (+9.7% 🔺) 1.732s 8 1.00x
▲ Vercel Express 2.776s (+36.8% 🔺) 4.328s (+23.6% 🔺) 1.552s 7 1.36x
▲ Vercel Next.js (Turbopack) 3.862s (+79.7% 🔺) 5.370s (+41.7% 🔺) 1.507s 6 1.89x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Promise.all with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.318s (-1.6%) 2.591s (+3.3%) 1.273s 12 1.00x
🐘 Postgres Express 1.327s (-4.7%) 2.316s (-13.4% 🟢) 0.989s 13 1.01x
🐘 Postgres Next.js (Turbopack) 1.485s (+13.2% 🔺) 2.236s (-23.4% 🟢) 0.751s 14 1.13x
💻 Local Nitro 2.544s (+5.6% 🔺) 3.343s (+14.5% 🔺) 0.799s 9 1.93x
💻 Local Express 2.601s (+10.3% 🔺) 3.110s (+6.6% 🔺) 0.509s 10 1.97x
💻 Local Next.js (Turbopack) 2.613s (-4.5%) 3.009s (-3.2%) 0.395s 10 1.98x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 2.986s (-17.8% 🟢) 4.498s (-12.9% 🟢) 1.512s 7 1.00x
▲ Vercel Nitro 3.079s (~) 5.530s (+6.7% 🔺) 2.451s 6 1.03x
▲ Vercel Next.js (Turbopack) 4.273s (+27.9% 🔺) 6.084s (+20.6% 🔺) 1.811s 5 1.43x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

Promise.all with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.596s (+0.6%) 4.011s (-6.8% 🟢) 2.416s 8 1.00x
🐘 Postgres Nitro 1.610s (-1.8%) 4.135s (-3.0%) 2.525s 8 1.01x
🐘 Postgres Next.js (Turbopack) 2.398s (-14.8% 🟢) 5.354s (-2.9%) 2.956s 6 1.50x
💻 Local Express 6.633s (+4.9%) 7.216s (+2.8%) 0.583s 5 4.16x
💻 Local Nitro 7.118s (+10.5% 🔺) 7.769s (+7.6% 🔺) 0.651s 4 4.46x
💻 Local Next.js (Turbopack) 7.336s (+34.0% 🔺) 8.268s (+37.5% 🔺) 0.932s 4 4.60x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 3.717s (+21.3% 🔺) 6.049s (+19.9% 🔺) 2.332s 6 1.00x
▲ Vercel Nitro 4.774s (+42.3% 🔺) 7.516s (+46.8% 🔺) 2.742s 4 1.28x
▲ Vercel Next.js (Turbopack) 5.238s (+50.5% 🔺) 7.622s (+46.6% 🔺) 2.385s 4 1.41x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

Promise.race with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.185s (+0.6%) 2.073s (+3.3%) 0.889s 15 1.00x
🐘 Postgres Nitro 1.185s (-1.8%) 2.007s (~) 0.822s 15 1.00x
🐘 Postgres Next.js (Turbopack) 1.239s (+5.9% 🔺) 2.010s (~) 0.771s 15 1.05x
💻 Local Express 1.441s (~) 2.007s (~) 0.565s 15 1.22x
💻 Local Nitro 1.455s (+2.3%) 2.007s (~) 0.553s 15 1.23x
💻 Local Next.js (Turbopack) 1.463s (+4.3%) 2.006s (~) 0.543s 15 1.24x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 2.151s (+4.2%) 3.456s (-1.2%) 1.305s 9 1.00x
▲ Vercel Nitro 2.799s (+30.6% 🔺) 4.653s (+25.2% 🔺) 1.855s 8 1.30x
▲ Vercel Next.js (Turbopack) 3.785s (-34.6% 🟢) 5.441s (-26.9% 🟢) 1.655s 6 1.76x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

Promise.race with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.313s (-4.3%) 2.509s (+1.5%) 1.196s 12 1.00x
🐘 Postgres Express 1.324s (-1.3%) 2.315s (-6.3% 🟢) 0.991s 13 1.01x
🐘 Postgres Next.js (Turbopack) 1.368s (+6.1% 🔺) 2.593s (-11.1% 🟢) 1.225s 12 1.04x
💻 Local Express 2.611s (+7.8% 🔺) 3.009s (-3.2%) 0.398s 10 1.99x
💻 Local Next.js (Turbopack) 2.613s (-0.9%) 3.109s (+3.3%) 0.496s 10 1.99x
💻 Local Nitro 2.717s (+5.3% 🔺) 3.454s (+11.1% 🔺) 0.737s 9 2.07x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 2.487s (-8.4% 🟢) 4.128s (-4.4%) 1.640s 8 1.00x
▲ Vercel Express 2.750s (-42.6% 🟢) 4.560s (-31.3% 🟢) 1.811s 7 1.11x
▲ Vercel Next.js (Turbopack) 4.940s (+4.1%) 6.867s (-1.2%) 1.927s 5 1.99x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Promise.race with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.641s (+3.5%) 4.296s (+3.9%) 2.656s 7 1.00x
🐘 Postgres Nitro 1.647s (-0.8%) 4.135s (+3.0%) 2.488s 8 1.00x
🐘 Postgres Next.js (Turbopack) 2.330s (-18.5% 🟢) 4.726s (-19.2% 🟢) 2.396s 7 1.42x
💻 Local Nitro 6.829s (+0.7%) 7.516s (+4.1%) 0.687s 4 4.16x
💻 Local Express 7.009s (+4.6%) 7.518s (+4.1%) 0.509s 4 4.27x
💻 Local Next.js (Turbopack) 7.075s (+23.6% 🔺) 7.616s (+26.6% 🔺) 0.542s 5 4.31x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 3.334s (-3.5%) 5.787s (+15.0% 🔺) 2.453s 6 1.00x
▲ Vercel Express 3.892s (-17.0% 🟢) 6.158s (-2.2%) 2.266s 5 1.17x
▲ Vercel Next.js (Turbopack) 5.093s (+63.1% 🔺) 7.410s (+43.5% 🔺) 2.317s 5 1.53x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.553s (+3.7%) 1.023s (~) 0.470s 59 1.00x
💻 Local Nitro 0.574s (-2.1%) 1.005s (~) 0.431s 60 1.04x
🐘 Postgres Nitro 0.576s (-3.1%) 1.023s (-1.7%) 0.447s 59 1.04x
💻 Local Express 0.599s (+4.5%) 1.005s (~) 0.407s 60 1.08x
💻 Local Next.js (Turbopack) 0.613s (+1.6%) 1.005s (-1.7%) 0.392s 60 1.11x
🐘 Postgres Next.js (Turbopack) 0.721s (+41.0% 🔺) 1.132s (+12.6% 🔺) 0.411s 55 1.30x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 2.595s (-1.9%) 4.199s (-2.3%) 1.603s 15 1.00x
▲ Vercel Express 3.085s (+10.3% 🔺) 4.622s (+3.0%) 1.537s 13 1.19x
▲ Vercel Next.js (Turbopack) 4.140s (+36.2% 🔺) 5.730s (+14.7% 🔺) 1.591s 11 1.60x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.288s (+2.9%) 2.030s (+1.1%) 0.742s 45 1.00x
🐘 Postgres Nitro 1.323s (-6.5% 🟢) 2.030s (-1.2%) 0.707s 45 1.03x
💻 Local Nitro 1.474s (-0.6%) 2.029s (+1.1%) 0.554s 45 1.14x
💻 Local Express 1.577s (+8.4% 🔺) 2.052s (+2.3%) 0.475s 44 1.22x
💻 Local Next.js (Turbopack) 1.585s (+8.0% 🔺) 2.029s (+1.1%) 0.443s 45 1.23x
🐘 Postgres Next.js (Turbopack) 1.825s (+46.7% 🔺) 2.297s (+13.2% 🔺) 0.472s 40 1.42x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 5.917s (-7.5% 🟢) 8.027s (+3.4%) 2.110s 12 1.00x
▲ Vercel Express 7.915s (+22.4% 🔺) 9.456s (+17.6% 🔺) 1.542s 10 1.34x
▲ Vercel Next.js (Turbopack) 10.129s (+41.8% 🔺) 12.110s (+36.2% 🔺) 1.981s 8 1.71x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 2.512s (-3.2%) 3.059s (-0.9%) 0.547s 40 1.00x
🐘 Postgres Nitro 2.591s (-4.6%) 3.058s (~) 0.467s 40 1.03x
🐘 Postgres Next.js (Turbopack) 3.150s (+27.2% 🔺) 3.682s (+20.4% 🔺) 0.532s 33 1.25x
💻 Local Nitro 3.177s (-1.3%) 3.977s (-0.8%) 0.800s 31 1.27x
💻 Local Express 3.243s (~) 4.010s (+0.8%) 0.767s 30 1.29x
💻 Local Next.js (Turbopack) 3.319s (+1.8%) 4.010s (-0.8%) 0.691s 30 1.32x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 11.510s (-18.1% 🟢) 14.248s (-8.8% 🟢) 2.738s 9 1.00x
▲ Vercel Express 14.736s (+6.9% 🔺) 17.222s (+11.4% 🔺) 2.486s 7 1.28x
▲ Vercel Next.js (Turbopack) 19.837s (+20.9% 🔺) 22.450s (+21.4% 🔺) 2.614s 6 1.72x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.217s (+3.3%) 1.006s (~) 0.789s 60 1.00x
🐘 Postgres Next.js (Turbopack) 0.226s (+34.6% 🔺) 1.017s (+1.1%) 0.791s 59 1.04x
🐘 Postgres Nitro 0.233s (+2.6%) 1.007s (~) 0.773s 60 1.07x
💻 Local Express 0.462s (+7.1% 🔺) 1.004s (~) 0.542s 60 2.12x
💻 Local Nitro 0.489s (+4.5%) 1.022s (+1.7%) 0.532s 59 2.25x
💻 Local Next.js (Turbopack) 0.649s (+11.0% 🔺) 1.022s (+1.7%) 0.374s 59 2.98x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 1.133s (-47.8% 🟢) 2.756s (-28.9% 🟢) 1.622s 22 1.00x
▲ Vercel Express 1.295s (-37.5% 🟢) 2.704s (-29.6% 🟢) 1.409s 23 1.14x
▲ Vercel Next.js (Turbopack) 2.498s (+37.4% 🔺) 4.304s (+21.3% 🔺) 1.806s 14 2.20x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.325s (~) 1.017s (~) 0.693s 89 1.00x
🐘 Postgres Nitro 0.328s (-2.6%) 1.006s (~) 0.678s 90 1.01x
🐘 Postgres Next.js (Turbopack) 0.444s (+65.6% 🔺) 1.086s (+7.9% 🔺) 0.642s 83 1.37x
💻 Local Nitro 2.101s (-1.5%) 2.657s (-1.1%) 0.556s 34 6.47x
💻 Local Express 2.185s (+1.1%) 2.744s (~) 0.558s 34 6.73x
💻 Local Next.js (Turbopack) 2.755s (-1.2%) 3.380s (+3.7%) 0.625s 27 8.49x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 1.439s (-24.5% 🟢) 3.342s (-4.2%) 1.903s 27 1.00x
▲ Vercel Express 1.798s (-27.0% 🟢) 3.478s (-14.2% 🟢) 1.680s 26 1.25x
▲ Vercel Next.js (Turbopack) 3.881s (+78.9% 🔺) 5.605s (+42.7% 🔺) 1.724s 17 2.70x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.505s (-2.2%) 1.107s (+3.6%) 0.602s 109 1.00x
🐘 Postgres Nitro 0.508s (-3.8%) 1.023s (-0.9%) 0.515s 118 1.01x
🐘 Postgres Next.js (Turbopack) 0.760s (+61.1% 🔺) 2.545s (-15.4% 🟢) 1.785s 48 1.51x
💻 Local Next.js (Turbopack) 9.982s (+2.0%) 10.937s (+1.5%) 0.955s 11 19.77x
💻 Local Nitro 10.035s (+1.2%) 11.026s (~) 0.991s 11 19.87x
💻 Local Express 10.384s (+2.9%) 11.304s (+1.6%) 0.920s 11 20.56x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 2.182s (-14.2% 🟢) 4.708s (+14.1% 🔺) 2.526s 26 1.00x
▲ Vercel Express 2.852s (+19.3% 🔺) 5.001s (+23.4% 🔺) 2.149s 24 1.31x
▲ Vercel Next.js (Turbopack) 4.705s (~) 7.246s (+10.7% 🔺) 2.541s 17 2.16x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Stream Benchmarks (includes TTFB metrics)
workflow with stream

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Next.js (Turbopack) 1.146s (-1.9%) 1.967s (~) 0.012s (-3.2%) 2.020s (~) 0.873s 10 1.00x
💻 Local Express 1.162s (+0.9%) 2.004s (~) 0.012s (+2.5%) 2.020s (~) 0.858s 10 1.01x
💻 Local Nitro 1.163s (~) 2.004s (~) 0.013s (+3.3%) 2.020s (~) 0.858s 10 1.01x
🐘 Postgres Nitro 1.163s (~) 1.999s (~) 0.001s (+18.2% 🔺) 2.010s (~) 0.847s 10 1.01x
🐘 Postgres Express 1.167s (+1.5%) 1.995s (~) 0.045s (+4410.0% 🔺) 2.056s (+2.3%) 0.888s 10 1.02x
🐘 Postgres Next.js (Turbopack) 1.182s (+3.1%) 2.001s (~) 0.001s (-18.2% 🟢) 2.031s (+1.1%) 0.849s 10 1.03x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 1.915s (-13.6% 🟢) 3.247s (-0.9%) 1.081s (-42.0% 🟢) 4.957s (-12.9% 🟢) 3.042s 10 1.00x
▲ Vercel Express 2.070s (+1.1%) 2.879s (-6.2% 🟢) 2.320s (+32.4% 🔺) 5.707s (+5.6% 🔺) 3.638s 10 1.08x
▲ Vercel Next.js (Turbopack) 3.802s (+84.1% 🔺) 4.233s (+22.7% 🔺) 1.519s (+7.7% 🔺) 7.203s (+33.2% 🔺) 3.401s 10 1.98x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

stream pipeline with 5 transform steps (1MB)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.523s (-1.6%) 2.005s (~) 0.005s (-4.2%) 2.025s (~) 0.502s 30 1.00x
💻 Local Nitro 1.541s (-0.8%) 2.008s (~) 0.012s (+3.3%) 2.024s (~) 0.483s 30 1.01x
💻 Local Express 1.570s (+1.4%) 2.010s (~) 0.012s (-6.5% 🟢) 2.025s (~) 0.455s 30 1.03x
🐘 Postgres Nitro 1.594s (-0.6%) 2.004s (~) 0.005s (+0.7%) 2.026s (~) 0.431s 30 1.05x
💻 Local Next.js (Turbopack) 1.599s (+1.4%) 1.968s (~) 0.012s (-6.2% 🟢) 2.025s (~) 0.426s 30 1.05x
🐘 Postgres Next.js (Turbopack) 2.127s (+38.1% 🔺) 2.506s (+24.6% 🔺) 0.004s (-15.1% 🟢) 2.532s (+25.0% 🔺) 0.405s 24 1.40x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 5.663s (-6.8% 🟢) 7.244s (+2.4%) 0.218s (-3.6%) 8.131s (+3.8%) 2.468s 8 1.00x
▲ Vercel Express 6.207s (+5.4% 🔺) 7.239s (~) 0.223s (+3.1%) 8.041s (+2.0%) 1.834s 8 1.10x
▲ Vercel Next.js (Turbopack) 10.272s (+72.9% 🔺) 11.411s (+54.8% 🔺) 0.177s (-44.5% 🟢) 12.676s (+53.5% 🔺) 2.404s 5 1.81x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

10 parallel streams (1MB each)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.759s (-1.9%) 1.029s (-1.8%) 0.000s (NaN%) 1.072s (+0.7%) 0.312s 56 1.00x
🐘 Postgres Nitro 0.810s (-1.5%) 1.085s (-1.2%) 0.000s (+47.3% 🔺) 1.099s (-1.8%) 0.289s 55 1.07x
💻 Local Nitro 1.237s (-6.2% 🟢) 1.948s (-1.7%) 0.000s (-50.0% 🟢) 1.951s (-1.7%) 0.714s 31 1.63x
💻 Local Express 1.310s (+3.3%) 2.013s (~) 0.000s (+100.0% 🔺) 2.016s (~) 0.707s 30 1.72x
💻 Local Next.js (Turbopack) 1.399s (+4.8%) 1.978s (~) 0.000s (+50.0% 🔺) 2.016s (~) 0.617s 30 1.84x
🐘 Postgres Next.js (Turbopack) 1.423s (+55.2% 🔺) 1.996s (+56.4% 🔺) 0.000s (-100.0% 🟢) 2.019s (+57.2% 🔺) 0.596s 30 1.87x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 3.088s (-21.0% 🟢) 4.135s (-17.7% 🟢) 0.000s (-15.4% 🟢) 4.652s (-16.0% 🟢) 1.564s 13 1.00x
▲ Vercel Nitro 3.135s (+0.5%) 4.680s (+6.1% 🔺) 0.000s (NaN%) 5.295s (+8.6% 🔺) 2.160s 12 1.02x
▲ Vercel Next.js (Turbopack) 5.892s (+79.0% 🔺) 6.278s (+33.5% 🔺) 0.000s (+50.0% 🔺) 7.686s (+46.3% 🔺) 1.793s 8 1.91x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

fan-out fan-in 10 streams (1MB each)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.795s (+5.9% 🔺) 2.396s (+6.2% 🔺) 0.000s (-64.0% 🟢) 2.430s (+7.1% 🔺) 0.635s 25 1.00x
🐘 Postgres Nitro 1.950s (+1.7%) 2.496s (~) 0.000s (+100.0% 🔺) 2.556s (+1.4%) 0.606s 24 1.09x
🐘 Postgres Next.js (Turbopack) 3.019s (+48.6% 🔺) 3.584s (+37.2% 🔺) 0.000s (+35.3% 🔺) 3.631s (+37.4% 🔺) 0.612s 17 1.68x
💻 Local Next.js (Turbopack) 3.519s (-3.9%) 4.126s (-1.6%) 0.001s (~) 4.172s (-1.5%) 0.652s 15 1.96x
💻 Local Nitro 3.528s (-1.1%) 4.026s (~) 0.000s (-82.4% 🟢) 4.031s (~) 0.503s 15 1.97x
💻 Local Express 3.755s (+3.3%) 4.228s (~) 0.001s (+150.0% 🔺) 4.234s (~) 0.479s 15 2.09x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 4.642s (-5.1% 🟢) 6.465s (+13.1% 🔺) 0.000s (NaN%) 7.103s (+14.8% 🔺) 2.461s 9 1.00x
▲ Vercel Express 4.812s (+1.6%) 5.898s (+2.7%) 0.000s (+100.0% 🔺) 6.384s (+2.1%) 1.572s 10 1.04x
▲ Vercel Next.js (Turbopack) 7.347s (+58.6% 🔺) 8.303s (+38.0% 🔺) 0.000s (-100.0% 🟢) 9.342s (+42.0% 🔺) 1.995s 7 1.58x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World 🥇 Fastest Framework Wins
💻 Local Nitro 10/21
🐘 Postgres Express 15/21
▲ Vercel Nitro 16/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework 🥇 Fastest World Wins
Express 🐘 Postgres 16/21
Next.js (Turbopack) 🐘 Postgres 14/21
Nitro 🐘 Postgres 15/21
Column Definitions
  • Workflow Time: Runtime reported by workflow (completedAt - createdAt) - primary metric
  • TTFB: Time to First Byte - time from workflow start until first stream byte received (stream benchmarks only)
  • Slurp: Time from first byte to complete stream consumption (stream benchmarks only)
  • Wall Time: Total testbench time (trigger workflow + poll for result)
  • Overhead: Testbench overhead (Wall Time - Workflow Time)
  • Samples: Number of benchmark iterations run
  • vs Fastest: How much slower compared to the fastest configuration for this benchmark

Worlds:

  • 💻 Local: In-memory filesystem world (local development)
  • 🐘 Postgres: PostgreSQL database world (local development)
  • ▲ Vercel: Vercel production/preview deployment
  • 🌐 Turso: Community world (local development)
  • 🌐 MongoDB: Community world (local development)
  • 🌐 Redis: Community world (local development)
  • 🌐 Jazz: Community world (local development)
  • 🌐 Redis: Community world (local development)
  • 🌐 Redis + BullMQ: Community world (local development)
  • 🌐 Cloudflare: Community world (local development)
  • 🌐 MySQL: Community world (local development)
  • 🌐 Azure: Community world (local development)
  • 🌐 NATS JetStream: Community world (local development)
  • 🌐 Upstash: Community world (local development)
  • 🌐 Platformatic: Community world (local development)

📋 View full workflow run

@github-actions

github-actions Bot commented Jun 17, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

✅ All tests passed

Summary

Passed Failed Skipped Total
✅ ▲ Vercel Production 1442 0 230 1672
✅ 💻 Local Development 1605 0 219 1824
✅ 📦 Local Production 1605 0 219 1824
✅ 🐘 Local Postgres 1593 0 231 1824
✅ 🪟 Windows 152 0 0 152
✅ 📋 Other 885 0 179 1064
Total 7282 0 1078 8360

Details by Category

✅ ▲ Vercel Production
App Passed Failed Skipped
✅ astro 125 0 27
✅ example 125 0 27
✅ express 125 0 27
✅ fastify 125 0 27
✅ hono 125 0 27
✅ nextjs-turbopack 149 0 3
✅ nextjs-webpack 149 0 3
✅ nitro 125 0 27
✅ nuxt 125 0 27
✅ sveltekit 144 0 8
✅ vite 125 0 27
✅ 💻 Local Development
App Passed Failed Skipped
✅ astro-stable 127 0 25
✅ express-stable 127 0 25
✅ fastify-stable 127 0 25
✅ hono-stable 127 0 25
✅ nextjs-turbopack-canary 133 0 19
✅ nextjs-turbopack-stable 152 0 0
✅ nextjs-webpack-canary 133 0 19
✅ nextjs-webpack-stable 152 0 0
✅ nitro-stable 127 0 25
✅ nuxt-stable 127 0 25
✅ sveltekit-stable 146 0 6
✅ vite-stable 127 0 25
✅ 📦 Local Production
App Passed Failed Skipped
✅ astro-stable 127 0 25
✅ express-stable 127 0 25
✅ fastify-stable 127 0 25
✅ hono-stable 127 0 25
✅ nextjs-turbopack-canary 133 0 19
✅ nextjs-turbopack-stable 152 0 0
✅ nextjs-webpack-canary 133 0 19
✅ nextjs-webpack-stable 152 0 0
✅ nitro-stable 127 0 25
✅ nuxt-stable 127 0 25
✅ sveltekit-stable 146 0 6
✅ vite-stable 127 0 25
✅ 🐘 Local Postgres
App Passed Failed Skipped
✅ astro-stable 126 0 26
✅ express-stable 126 0 26
✅ fastify-stable 126 0 26
✅ hono-stable 126 0 26
✅ nextjs-turbopack-canary 132 0 20
✅ nextjs-turbopack-stable 151 0 1
✅ nextjs-webpack-canary 132 0 20
✅ nextjs-webpack-stable 151 0 1
✅ nitro-stable 126 0 26
✅ nuxt-stable 126 0 26
✅ sveltekit-stable 145 0 7
✅ vite-stable 126 0 26
✅ 🪟 Windows
App Passed Failed Skipped
✅ nextjs-turbopack 152 0 0
✅ 📋 Other
App Passed Failed Skipped
✅ e2e-local-dev-nest-stable 127 0 25
✅ e2e-local-dev-tanstack-start- 127 0 25
✅ e2e-local-postgres-nest-stable 126 0 26
✅ e2e-local-postgres-tanstack-start- 126 0 26
✅ e2e-local-prod-nest-stable 127 0 25
✅ e2e-local-prod-tanstack-start- 127 0 25
✅ e2e-vercel-prod-tanstack-start 125 0 27

📋 View full workflow run

@NathanColosimo
Add typed workflow configuration
d30869c 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Honor environment config precedence
2ce4f5d 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Remove world provider identifiers
217c41b 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Simplify unified workflow configuration
f83c6b9 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Fix staged package resolution
f671e3b 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Simplify World configuration factories
d5c5d41 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Document static workflow configuration
2b42095 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Simplify config integration plumbing
4ae0616 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Refine workflow configuration docs
c3d29df 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Refine module-based workflow configuration
7984315 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Fix configured World lifecycle and paths
5811b2a 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Simplify shared config integration
acc1527 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Fix Nitro runtime config bundling
82c8ac6 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Avoid config writes during Next startup
d6bf4fc 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Preserve standalone workflow discovery
b7b2686 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Clarify World selection and configuration
ae3f5b7 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Fix config-backed runtime selection
8e34ed6 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Fix framework runtime config wiring
17b30ae 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Wire shared config into Vite frameworks
ed092da 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Unify runtime namespace and World lifecycle
7d0f68c 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Fix CLI World lifecycle and provider validation
8b9e8e3 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Fix runtime World replacement consistency
3648668 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Simplify shared config plumbing
b9fd441 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Fix config integration fallbacks
415cff8 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Preserve configless queue namespace
e7170de 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Keep configured world lifecycle consistent
de7193d 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Keep World providers lazy and namespaced
b7e2553 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
@NathanColosimo
Simplify unified workflow configuration
e393dbf 
Signed-off-by: Nathan Colosimo <110621881+NathanColosimo@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@ijjk ijjk Awaiting requested review from ijjk ijjk will be requested when the pull request is marked ready for review ijjk is a code owner

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Standardize SDK configuration: introduce workflow.config.ts (RFC)

1 participant

@NathanColosimo